Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-022 |
| Deskripsi | Laporan penjualan konsinyasi bulanan per customer konsinyasi: total penjualan, rincian invoice, barang terjual, dan cetak laporan |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka Laporan Penjualan Konsinyasi.
- User memilih satu atau beberapa customer konsinyasi dan satu bulan periode.
- User melihat total penjualan konsinyasi per customer dan grand total seluruh customer.
- User membuka rincian invoice per customer, lalu rincian barang per invoice (nama barang, kuantitas, harga).
- User mencetak laporan dengan pilihan ukuran kertas CF full size atau CF PRS size.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem hanya menawarkan customer yang ditandai sebagai customer konsinyasi |
| FR-02 | Sistem menampilkan total penjualan konsinyasi per customer untuk bulan terpilih beserta grand total |
| FR-03 | User dapat membuka rincian invoice dan rincian barang per invoice |
| FR-04 | User dapat mencetak laporan dengan pilihan ukuran kertas |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Menampilkan penjualan konsinyasi per customer untuk satu bulan |
| UC-02 | Melihat rincian invoice dan barang konsinyasi |
| UC-03 | Mencetak laporan penjualan konsinyasi |
4. Use Case Scenario
UC-01 : Menampilkan penjualan konsinyasi per customer untuk satu bulan
| Aktor | User penjualan / akuntansi |
| Deskripsi | User melihat total penjualan konsinyasi tiap customer konsinyasi dalam satu bulan |
| Prekondisi | User sudah login dan brand memiliki customer konsinyasi |
| Alur utama | 1. User membuka halaman Laporan Penjualan Konsinyasi. 2. User memilih customer konsinyasi (boleh lebih dari satu). 3. User memilih bulan periode. 4. User menekan tombol Tampilkan. 5. Sistem menampilkan nama customer dan total penjualan, serta Grand Total Penjualan Konsinyasi. |
| Alur negatif | - Jika customer atau periode belum diisi, muncul alert "Lengkapi Customer dan Periode Terlebih Dahulu". - Jika data salah satu customer gagal dimuat, customer tersebut dilewati. - Jika tidak ada data sama sekali, tabel dan tombol cetak tidak ditampilkan. |
| Bisnis rule | - Periode selalu satu bulan penuh, dari tanggal 1 sampai akhir bulan terpilih. - Hanya transaksi konsinyasi yang sudah tercetak yang dihitung. - Data diambil satu per satu untuk setiap customer terpilih. - Customer dan bulan terakhir disimpan di query alamat halaman. |
| Postkondisi | Total penjualan konsinyasi per customer tampil |
| Trigger | User menekan tombol Tampilkan |
| Kode FR | FR-01 FR-02 |
UC-02 : Melihat rincian invoice dan barang konsinyasi
| Aktor | User penjualan / akuntansi |
| Deskripsi | User menelusuri invoice dan barang di balik total customer |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User menekan tanda panah pada baris customer. 2. Sistem menampilkan daftar nomor invoice dan total per invoice. 3. User membuka baris invoice. 4. Sistem menampilkan nama barang, kuantitas, dan harga. |
| Alur negatif | - Jika data SKU gagal dimuat, nama barang tidak tampil. |
| Bisnis rule | - Nama barang dilengkapi per SKU dari master barang. |
| Postkondisi | Rincian invoice dan barang tampil |
| Trigger | User membuka baris customer atau invoice |
| Kode FR | FR-03 |
UC-03 : Mencetak laporan penjualan konsinyasi
| Aktor | User penjualan / akuntansi |
| Deskripsi | User mencetak laporan konsinyasi yang sedang tampil |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User menekan tombol cetak. 2. Sistem membuka popup "Pilih Tipe Kertas". 3. User memilih CF Full Size atau CF PRS Size lalu menekan print. 4. Sistem melengkapi nama barang tiap baris dan membuka dialog cetak. |
| Alur negatif | - Tombol cetak nonaktif jika belum ada data. - Jika data SKU gagal dimuat, nama barang dicetak kosong. |
| Bisnis rule | - Dokumen cetak memuat total per customer, rincian invoice dan barang, serta grand total. - Laporan ini tidak memiliki ekspor Excel. |
| Postkondisi | Dialog cetak terbuka |
| Trigger | User menekan tombol cetak |
| Kode FR | FR-04 |
5. Data Flow Diagram
DFD-01 — Alur data penjualan konsinyasi
6. Sequence Diagram
SD-01 — UC-01 : Menampilkan penjualan konsinyasi per customer untuk satu bulan
SD-02 — UC-02 : Melihat rincian invoice dan barang konsinyasi
SD-03 — UC-03 : Mencetak laporan penjualan konsinyasi
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /customer | existing | - |
GET /laporan-penjualan-konsinyasi | existing | - |
GET /sku/:id | existing | - |